SAP Web Dispatcher: Error Messages While Adding a New System Through HTTP Connection

In case you are trying to add a new SAP Web Dispatcher system for the monitoring and some of the prerequisites are not fulfilled (the minimum required CrystalBridge® Monitoring version is installed on the system or required HTTP destination was not configured correctly), then one of the following errors can be raised during this action.

SAP Web Dispatcher: HTTP error (RECEIVE_RESPONSE): 401 unauthorized

This error is mainly raised when the configured HTTP destination has defined an incorrect value in the Path Prefix field in the Technical settings tab. You can retrieve this path from the URL address while accessing the SAP Web Dispatcher administration interface or from the configuration file sapwebdisp.pfl available in the installation directory of this SAP Web Dispatcher. By default, in most installations, this path is defined as /sap/wdisp/admin.

This path cannot contain any additions (e.g. /public/default.html) because the monitoring automatically concatenates the correct path to the required service of the SAP Web Dispatcher in order to retrieve the monitoring-related data.

To resolve this error, please check and validate if the correct path prefix value is defined in the configured HTTP destination.

SAP Web Dispatcher: No cookies found for ICM admin session logon action

If you are running SAP Web Dispatcher version 7.81 or higher, the monitoring must retrieve the cookies according to the configured HTTP destination to be able to communicate with the SAP Web Dispatcher instance from the central SAP system. This message is the mostly caused by the following:

  • Incorrect credentials for the SAP Web Dispatcher user were provided for the configured HTTP destination. Make sure that this user exists on the SAP Web Dispatcher and that the user is not locked.

  • The option Accept Cookies was not set to the value Yes (All) in the configured HTTP destination (Special Options > HTTP Cookies).

To resolve this error, check and validate the both above-mentioned points and make the necessary changes.

NOTE In version 24.05, there was a bug that if the SAP Web Dispatcher user has any special characters defined in their password, this error message was raised. In this scenario, upgrade CrystalBridge Monitoring to the latest version. This issue was resolved in version 24.08 version.

SAP Web Dispatcher: HTTP Error (RECEIVE_RESPONSE): 401 ICM_HTTP_*

ICM HTTP-related errors are caused by an incorrectly defined SSL client certificate used for SAP Web Dispatcher monitoring on the central SAP system. There are two different errors for this message:

  • ICM_HTTP_CONNECTION_BROKEN: HTTPS communication is configured but no valid SSL client certificate was defined in the HTTP destination.

  • ICM_HTTP_SSL_ERROR: The defined SSL client certificate in the HTTP destination is not valid. For example, the certificate from the SAP Web Dispatcher was not imported correctly to the SSL client certificate on the central SAP system.

To resolve this error, please check and validate the SSL client certificate used for SAP Web Dispatcher monitoring on the central SAP system with your SAP Basis team.

Substring access (offset = 0, length = 1) to a data object of the size 0 exceeds valid boundaries

The root cause of this error is that you are using an old version of CrystalBridge Monitoring (24.02 or lower). In older versions, the monitoring HTTP requests are redirected to the logon screen of the SAP Web Dispatcher administration interface instead of the required service. This is caused by SAP Note 3277881, in which basic HTTP authentication was forbidden.

To avoid this unexpected error message, upgrade to the latest CrystalBridge Monitoring version and add a new SAP Web Dispatcher system to the upgraded version. Apart from the upgrade procedure, there is no other workaround to avoid this error.